package com.ruoyi.creditlife.service;

import com.ruoyi.creditlife.domain.ComplianceRecord;

import java.util.List;
import java.util.Map;

/**
 * 用户守约记录Service接口
 * 
 * @author ddd
 * @date 2025-06-30
 */
public interface IComplianceRecordService 
{
    /**
     * 统计用户守约记录总数
     * @param userId 用户ID
     * @return 记录总数
     */
    int countComplianceRecords(Long userId);

    /**
     * 获取用户近期守约率
     * @param userId 用户ID
     * @param months 最近几个月
     * @return 守约率(0-100)
     */
    double getRecentComplianceRate(Long userId, int months);

    /**
     * 获取用户守约类型分布
     * @param userId 用户ID
     * @return 类型分布列表
     */
    List<Map<String, Object>> getTypeDistribution(Long userId);


    /**
     * 查询用户守约记录
     * 
     * @param id 用户守约记录主键
     * @return 用户守约记录
     */
    public ComplianceRecord selectComplianceRecordById(Long id);

    /**
     * 查询用户守约记录列表
     * 
     * @param complianceRecord 用户守约记录
     * @return 用户守约记录集合
     */
    public List<ComplianceRecord> selectComplianceRecordList(ComplianceRecord complianceRecord);

    /**
     * 新增用户守约记录
     * 
     * @param complianceRecord 用户守约记录
     * @return 结果
     */
    public int insertComplianceRecord(ComplianceRecord complianceRecord);

    /**
     * 修改用户守约记录
     * 
     * @param complianceRecord 用户守约记录
     * @return 结果
     */
    public int updateComplianceRecord(ComplianceRecord complianceRecord);

    /**
     * 批量删除用户守约记录
     * 
     * @param ids 需要删除的用户守约记录主键集合
     * @return 结果
     */
    public int deleteComplianceRecordByIds(Long[] ids);

    /**
     * 删除用户守约记录信息
     * 
     * @param id 用户守约记录主键
     * @return 结果
     */
    public int deleteComplianceRecordById(Long id);
}
